home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / basic / ideclar.exe / IDECLARE.DOC < prev    next >
Encoding:
Text File  |  1992-12-06  |  6.3 KB  |  97 lines
  1. 12/06/92, Chicago. IDeclare initial release 1.0.
  2.         Welcome to IDeclare. This program was designed to solve a problem 
  3. that frequently popped up while programming in QuickBasic 4.5, namely the 
  4. existence of duplicate declarations between long and complex include files.
  5. Upon finding such, QB stops in its tracks, an activity that can be quite 
  6. annoying. This program was designed to allow one or more include files to be
  7. used to create customized include files for whatever program module(s) the
  8. user selects. Up to 32 include files, and 32 modules can be referenced, as 
  9. long as sufficient memory exists. 
  10.         Start the program by typing "IDeclare" from the appropriate directory.
  11. IDeclare does not accept command line options at this time. 
  12.         In order to add another file while entering the files, simply append 
  13. a "+" to the name entered. The program will interpret this as "There is 
  14. another file I want processed as well." 
  15.         For example, suppose you are entering the first of two include files 
  16. to be processed by the program, Advbas2.bi. You would type "Advas2.bi+" (but not 
  17. the quotation marks), press enter, and then the program will list the include 
  18. files and ask you again for the name of the include file to process. You would 
  19. then type the second name and press enter. Then the program will prompt you 
  20. for names of modules. 
  21.         Enter only one name per question. You may simply press enter without 
  22. entering anything else if you wish to skip either the modules or include files.
  23. Skipping the module(s) results in an empty include file, and skipping both 
  24. scoots you right out of the program.
  25.         This program will keep track of all declarations in the selected
  26. include files, and, at the user's discretion, those contained in the selected
  27. module(s) or contained in include files referenced by the module(s). The
  28. automatically eliminates duplicates while reading the declarations. The 
  29. eliminated declarations are those that are read latest in the order listed 
  30. here: 1) Declarations directly from the module(s) 2) declarations contained
  31. in selected include files in the order entered 3) declarations contained in
  32. include files referenced by the module(s) in the order referenced. Items 1) 
  33. and 3) and their declarations may be omitted by answering N when asked by the
  34. program whether to include declarations and include files from the module(s).
  35. By the way, this step can take over a minute with long include files or 
  36. modules.
  37.         After building the list of nonredundant declarations, the program 
  38. searches through the module(s) for references and uses of the declared 
  39. procedures, noting which declared procedures are actually used in the module(s).
  40. Those which are not used are omitted from the list. The program then checks to
  41. see whether an include file exists that is named after the first module. If so,
  42. it asks the user whether to replace it. If the user answers N, then the 
  43. program asks the user to type in the name of the new include file to create.
  44.         Once the new streamlined include file has been created, the user should then
  45. remove all other references to included files in the module(s), as well as 
  46. attempting to make sure that no module level declarations duplicate those of the
  47. new include file. IDeclare does NOT remove declarations from modules (or 
  48. include files)!! Once these references and declarations are removed from the
  49. module(s), then the new include file can be used.
  50.         It would probably be rather prudent at this juncture to point out that
  51. one possible use of this program is as an aid in the creation of small
  52. customized libraries. One can use utilities such as the LIBWIZ utilities to
  53. create customized libraries from large behemoths like PBClone, ProBas, and
  54. so on, the advantage of course being in memory usage and space. But to use
  55. LIBWIZ, one must have an include file that contains declarations for only
  56. the procedures to be placed in the library. Using IDeclare, one can create
  57. programs using whatever procedures from these large massive libraries the user 
  58. wishes, and then run IDeclare using an include file listing all the library's
  59. procedures, and the newly-created program as the module. The resulting include
  60. file contains declarations only for those procedures used in the program. This 
  61. can be done for up to 32 programs at a time, culling out of the big include
  62. file(s) only what is used in those programs. The resulting include file can then
  63. be used with the LIBWIZU utility to create the preliminary INF file used by 
  64. LIBWIZ to create a custom library containing only those procedures you
  65. actually use in your programs. The primary advantage of customized quick 
  66. libraries made in this fashion is that they can free up enough memory to 
  67. enable some programs to be run from within the QB environment that would 
  68. otherwise require compiling and linking first. The primary advantage of 
  69. regular libraries made in this fashion is that they signficantly reduce the
  70. memory overhead during compiling and linking, and for some available libraries
  71. that can make the difference between being able to complete the job or getting
  72. the ever-popular "Out of memory" error warning.
  73.         This is the first release of this program. The QuickBasic code for 
  74. this program is available on disk (specify size) for 25$. Users of this program 
  75. who find it useful are encouraged to register by sending the modest fee of 5$
  76. to the address below. 
  77.         This program was designed and tested on a 286 with a VGA monitor, but 
  78. should work as well on other types, though I don't know how things
  79. turn out on a monochrome monitor, or an XT-compatible. USE THIS PROGRAM AT 
  80. YOUR OWN RISK!! There are NO guarantees or warranties, express or implied,
  81. associated with this software in any way.
  82.         Suggestions for improvement, and/or bug reports should be sent via 
  83. E-mail on CompuServe at 70744,1775, GEnie at J.Jacobson16, or via the Postal
  84. Service to
  85.                 John M. Jacobson
  86.                 1140 N. La Salle, Apt. 108
  87.                 Chicago, Illinois
  88.  
  89.         Please note that LIBWIZ, LIBWIZU, and PBClone are not associated in 
  90. any manner with the author of this program. They are fine shareware products 
  91. created and copyrighted by Thomas G. Hanlin, III, and are NOT packaged with 
  92. this program. If you use these products you should register according to the 
  93. instructions contained therein.
  94.  
  95.  
  96.  
  97.